home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / lastcl10.zip / LASTCALL.DOC < prev    next >
Text File  |  1993-01-11  |  9KB  |  200 lines
  1. ---------------------------------------------------------------------------        
  2.       LastCallers v1.0  Copyright (c) 1993 by Bryan J. Nylin
  3.                         Written and compiled in QuickBASIC v4.5
  4. ---------------------------------------------------------------------------
  5.  
  6. LastCallers v1.0 is a utility designed for TriBBS sysops to create a 
  7. bulletin showing the latest users to call the BBS.  It is compatible 
  8. with TriBBS v3.3 - No other versions have been tested.
  9.  
  10. This software is SHAREWARE.  You are granted permission to distribute
  11. the LASTCL10 archive freely, provided all the original files are kept 
  12. together, and only a nominal fee is charged.  The files in this archive 
  13. should be:
  14.  
  15.         LASTCALL.DOC      This documentation file.
  16.         LASTCALL.REG      Registration/order form
  17.         LASTCALL.EXE      Executable program.
  18.         LASTCALL.CFG      Configuration file
  19.         FILE_ID.DIZ       Program description for BBS posting.
  20.  
  21. The result of McAffee's VALIDATE program on LASTCALL.EXE is as follows:          
  22.  
  23.                   File Name:  LASTCALL.EXE
  24.                        Size:  52,698
  25.                        Date:  1-10-1992
  26.         File Authentication:
  27.              Check Method 1 - B45B
  28.              Check Method 2 - 0EBD
  29.  
  30. If any of these numbers do not match, you have an invalid archive that
  31. might be infected with a virus.  Delete the archive and contact the
  32. person or BBS you received it from.
  33.  
  34. This SHAREWARE program is distributed with the concept that if you find
  35. it useful and continue to use it beyond a 30-day free trial period, you
  36. must send in the $10 registration fee (discounts available when registering
  37. multiple copies and/or additional utilities at the same time).
  38.  
  39. To help you evaluate the program, no features have been left out of this 
  40. shareware release.  See the file LASTCALL.REG for the order form.
  41.  
  42.  
  43. INSTALLATION INSTRUCTIONS:
  44. -------------------------------------------------------------------------
  45. Step 1.         Extract the files from the distribution archive into 
  46.                 your BBS utilities directory. (I use \BBS\UTIL)
  47.  
  48. Step 2.         Make your utilities directory the default (CD \BBS\UTIL)
  49.  
  50. Step 3.         Edit LASTCALL.CFG to match your system configuration.
  51.                 Each line is documented in a section below.
  52.  
  53. Step 4.         Run LASTCALL with the /R parameter to reset the datafile.
  54.                 This will create LASTCALL.DAT in your utilities directory.
  55.                                                                           
  56. Step 5.         Edit your TriBBS BETWEEN.BAT file to include LASTCALL.
  57.                 Example:
  58.                 ---------->File starts Here<-------------
  59.                 cd\bbs\util
  60.                 LASTCALL /L /E=999
  61.                 cd\bbs\tribbs
  62.                 ---------->File ends Here<-----------------
  63.  
  64. Step 6.         You are done!  The next time a caller logs off and 
  65.                 BETWEEN.BAT is executed, the bulletin is updated.
  66.                 
  67.  
  68. CONFIGURATION FILE
  69. -------------------------------------------------------------------------
  70. The sample file LASTCALL.CFG included in this archive looks like this:
  71.  
  72. ---------->File starts Here<-------------
  73. bbs=Jet City Connection
  74. log=J:\BBS\TRIBBS\MWORK\CALLERS.LOG
  75. dir=J:\BBS\TRIBBS
  76. max=15
  77. ansi=J:\BBS\tribbs\display\BULLET5.ANS
  78. ascii=J:\BBS\tribbs\display\BULLET5.BBS
  79. ---------->File ends Here<-----------------
  80.  
  81. Each line starts with a TAG and an equal sign.  These must be typed
  82. correctly in order for the LASTCALL program to recognize them.  It is
  83. not case sensitive, however.  Each tag is explained as follows:
  84.  
  85.         bbs=    Name of the BBS you want to appear at top of bulletin.
  86.  
  87.         log=    File name of caller log to read.  LASTCALL looks only at
  88.                 the last caller in the log file.
  89.  
  90.         dir=    Main TriBBS directory (Node 1).
  91.  
  92.         max=    Maximum number of lines to print in the bulletin.  A
  93.                 '15' here would indicate to only print the last 15
  94.                 callers.
  95.                 
  96.         ansi=   File name and path of the ANSI bulletin to create.
  97.  
  98.         ascii=  File name and path of the ASCII bulletin to create.
  99.  
  100.  
  101. COMMAND LINE PARAMETERS:
  102. --------------------------------------------------------------------------
  103. Usage:  LASTCALL [/F] [/R] [/L] [/E=nnn] [/?] [/HELP]
  104. Where:  /F      Forces bulletin output even if last caller was not new.
  105.         /R      Resets datafile
  106.         /L      Includes local logons
  107.         /E=nnn  Excludes callers at or above security level nnn.
  108.  
  109. Explanation:
  110.  
  111.         /F      Normally, the program only generates the bulletin when
  112.                 the last caller was a new user.  This switch will force
  113.                 the output regardless of that fact.
  114.  
  115.         /R      This switch will cause LASTCALL.DAT to be cleared out
  116.                 before looking at the log file.
  117.  
  118.         /L      Includes local logons.  By default local logons are
  119.                 ignored and not recorded.
  120.  
  121.         /E=nnn  Excludes any caller with a security level at or above 
  122.                 'nnn'.  Useful to exclude sysop from list when calling
  123.                 from remote line.
  124.  
  125.  
  126. EXAMPLE:        NEWUSERS /L /E=999
  127.                 
  128.                 Includes local logons, but excludes any users at level 999
  129.                 (or above).  Handy if there are users other than the sysop
  130.                 that log on locally that should be on the list.  Also
  131.                 keeps a sysop from being recorded when calling by modem.
  132.  
  133.  
  134. LASTCALL.DAT Layout
  135. --------------------------------------------------------------------------
  136. This is a straight forward ASCII file.  It was programmed this way for
  137. easy access by the sysop in case it is necessary to edit out a name from
  138. the last caller list.  Generally speaking, you can delete records from this
  139. file without causing any problems, any empty space will be taken up the
  140. next time LASTCALL runs.  You must BE CAREFUL TO DELETE WHOLE RECORDS.
  141. One record consists of:
  142.  
  143.         Line 1          John Doe        User Name
  144.         Line 2          01/08/92        Date of first call
  145.         Line 3          2400            Baud rate
  146.         Line 4          Nowhere, WA     City, State
  147.         Line 5          21:01           Time On
  148.         Line 6          21:30           Time Off
  149.         Line 7          -               Dropped Carrier ('-'=d/c, ' '=no)
  150.         Line 8          1               Node #
  151.  
  152. Empty records are stored as "Empty, 00/00/00, 0, etc." and are easily 
  153. identifiable. If you add or delete from this file, make sure you work 
  154. with a GROUP OF 8 LINES ONLY.  If you don't, odd results will happen and 
  155. you will probably have to run LASTCALL /R to reset the datafile.
  156.  
  157. Notice the '-' dropped carrier flag.  This is a little obscure, but this
  158. character prints directly after the baud rate when the caller dropped
  159. carrier.  Since this is not something users generally concern themselves
  160. with, and the amount of data was already pretty jammed, this seemed
  161. sufficient.  A sysop can look at the list and see who dropped carrier
  162. very easily (a '2400-' is one that dropped carrier, '2400' was fine).
  163. If you happen to edit Line 7, it should either have a '-' or a space.
  164. If the line is empty or has several blanks the report format will be off.
  165.  
  166.  
  167. DESCRIPTION OF OPERATION
  168. --------------------------------------------------------------------------
  169. LASTCALL will open the LASTCALL.DAT file and add all the information 
  170. into the DAT file for the last caller.  It also opens the USERS.DAT file 
  171. in the Node 1 MWORK directory to get the City, State where the caller 
  172. is from and their call number.  If the number of records in LASTCALL.DAT 
  173. exceeds that specified by the "max=" tag in LASTCALL.CFG, the oldest 
  174. record will be scrolled off the list.   
  175.  
  176. --------------------------------------------------------------------------
  177.         
  178.         Support questions can be left, and latest version downloaded
  179.         from the author's BBS near Seattle, WA:
  180.  
  181.         Jet City Connection BBS, (206)839-8843, v.32bis, Fido 1:343/140
  182.  
  183.         Messages can also be addressed to Bryan Nylin at:
  184.                 
  185.                 FidoNet 1:343/140
  186.                 CompuServe 71441,1420
  187.                 
  188. ---------------------------------------------------------------------------
  189.  
  190. This SHAREWARE program is distributed with the concept that if you find
  191. it useful and continue to use it beyond a 30-day free trial period, you
  192. must send in the $10 registration fee (discounts available when registering
  193. multiple copies and/or additional utilities at the same time).
  194.  
  195. To help you evaluate the program, no features have been left out of this 
  196. shareware release.  See the file LASTCALL.REG for the order form.
  197.  
  198. ---------------------------------------------------------------------------        
  199.  
  200.